home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / scsiha.z / scsiha
Encoding:
Text File  |  2001-04-17  |  13.8 KB  |  199 lines
  1.  
  2.  
  3.  
  4. ssssccccssssiiiihhhhaaaa((((1111mmmm))))                                                          ssssccccssssiiiihhhhaaaa((((1111mmmm))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      scsiha - probe and control scsi buses
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      ssssccccssssiiiihhhhaaaa [----llllpppprrrrttttwwww] [----DDDD _d_e_b_u_g_l_e_v_e_l] [----LLLL _t_a_r_g_e_t_I_D|aaaallllllll] {_b_u_s__n_u_m_b_e_r | _d_e_v_i_c_e} ...
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      _s_c_s_i_h_a is used to perform operations on fibrechannel loops of SCSI
  16.      devices and parallel SCSI buses.
  17.  
  18.      The following options apply to both parallel SCSI and fibrechannel SCSI:
  19.  
  20.      ----pppp   Probe for devices on the bus or loop.  On parallel SCSI buses, this
  21.           option causes the driver to look for devices at every ID on the SCSI
  22.           bus.  On fibrechannel SCSI loops, this option causes the driver to
  23.           look for devices at every ID that was reported in use at the most
  24.           recent loop initialization.  On parallel SCSI buses, when a device
  25.           is found at lun 0, all other luns are then probed.  When devices or
  26.           luns are not valid, a warning message may be printed on the console.
  27.           With fibrechannel, the Report Luns SCSI command is used to determine
  28.           which LUNs are valid.  If the Report Luns command returns error,
  29.           only LUN 0 is assumed to be valid.
  30.  
  31.           After probing, new devices will have a controller number of "-1"
  32.           until iiiiooooccccoooonnnnffffiiiigggg ----ffff ////hhhhwwww is run to update the hardware graph.
  33.  
  34.      ----rrrr   Perform a SCSI bus reset and/or reset host adapter.
  35.  
  36.           TTTThhhhiiiissss aaaaffffffffeeeeccccttttssss aaaallllllll ddddeeeevvvviiiicccceeeessss oooonnnn tttthhhhaaaatttt SSSSCCCCSSSSIIII bbbbuuuussss,,,, ccccaaaauuuussssiiiinnnngggg ccccuuuurrrrrrrreeeennnntttt ccccoooommmmmmmmaaaannnnddddssss
  37.           ttttoooo bbbbeeee aaaabbbboooorrrrtttteeeedddd,,,, aaaannnndddd ssssppppeeeecccciiiiaaaallllllllyyyy sssseeeetttt ppppaaaarrrraaaammmmeeeetttteeeerrrrssss ttttoooo bbbbeeee rrrreeeesssseeeetttt,,,, iiiinnnn mmmmaaaannnnyyyy
  38.           ccccaaaasssseeeessss....  TTTTaaaappppeeee ddddrrrriiiivvvveeee ssssttttaaaatttteeee wwwwiiiillllllll bbbbeeee rrrreeeesssseeeetttt aaaafffftttteeeerrrr tttthhhhiiiissss,,,, aaaannnndddd aaaannnnyyyy ttttaaaappppeeee
  39.           ooooppppeeeerrrraaaattttiiiioooonnnnssss iiiinnnn pppprrrrooooggggrrrreeeessssssss wwwwiiiillllllll bbbbeeee aaaabbbboooorrrrtttteeeedddd.
  40.  
  41.           This option should therefore be used with some caution.  In very
  42.           rare cases, it may cause a device to become unusable without a
  43.           powercycle.  There are times when it is desired to reset devices or
  44.           adapters that appear to be hung, however, so this function is
  45.           provided.  Some host adapter drivers will reset the adapter as part
  46.           of this ioctl.  Fibrechannel adapters will perform loop
  47.           initialization, making this operation similar to the ----llll option,
  48.           except that the adapter will also be reset.
  49.  
  50.      ----DDDD _d_e_b_u_g_l_e_v_e_l
  51.           Set the debug level in the host adapter driver.  Where supported,
  52.           this option changes the verbosity of a given host adapter driver.
  53.           In general, 0 is least verbose, with no specific upward limit.
  54.  
  55.      The following option only applies to some parallel SCSI adapters:
  56.  
  57.      ----tttt   Return interesting SCSI bus and attached target parameters. Bus
  58.           parameters include whether the bus is single-ended or differential,
  59.           the SCSI host ID and the selection timeout. The target parameters
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. ssssccccssssiiiihhhhaaaa((((1111mmmm))))                                                          ssssccccssssiiiihhhhaaaa((((1111mmmm))))
  71.  
  72.  
  73.  
  74.           include whether the device is capable of operating in narrow or wide
  75.           mode, whether it's capable of doing synchronous transfer and if so,
  76.           what the period and offset is.
  77.  
  78.      The following options only apply to Fibrechannel SCSI adapters:
  79.  
  80.      ----llll   Perform loop initialization.  During loop initialization, all
  81.           devices on the loop will attempt to acquire a target ID.  SGI
  82.           devices will attempt to get the ID they have been selected for,
  83.           either by settings on and position within an enclosure, or by
  84.           dials/switches on the device.  If multiple devices have the same ID
  85.           selection, only one device will get that ID.  Other devices will
  86.           attempt to acquire IDs not in already in use.
  87.  
  88.           TTTThhhhiiiissss ooooppppttttiiiioooonnnn mmmmaaaayyyy hhhhaaaavvvveeee aaaa ssssiiiiddddeeee eeeeffffffffeeeecccctttt ooooffff aaaabbbboooorrrrttttiiiinnnngggg ccccuuuurrrrrrrreeeennnntttt ccccoooommmmmmmmaaaannnnddddssss
  89.           oooouuuuttttssssttttaaaannnnddddiiiinnnngggg oooonnnn tttthhhheeee aaaaddddaaaapppptttteeeerrrr,,,, ssssoooo iiiitttt sssshhhhoooouuuulllldddd bbbbeeee uuuusssseeeedddd wwwwiiiitttthhhh ccccaaaarrrreeee....  TTTThhhheeee
  90.           ddddiiiisssskkkk ddddrrrriiiivvvveeeerrrr wwwwiiiillllllll ttttyyyyppppiiiiccccaaaallllllllyyyy rrrreeeeiiiissssssssuuuueeee tttthhhheeee aaaabbbboooorrrrtttteeeedddd ccccoooommmmmmmmaaaannnnddddssss,,,, bbbbuuuutttt tttthhhheeeerrrreeee
  91.           wwwwiiiillllllll bbbbeeee aaaa ppppeeeerrrrffffoooorrrrmmmmaaaannnncccceeee iiiimmmmppppaaaacccctttt wwwwhhhhiiiilllleeee ccccoooommmmmmmmaaaannnnddddssss aaaarrrreeee rrrreeeeiiiissssssssuuuueeeedddd....
  92.  
  93.  
  94.  
  95.      ----LLLL _t_a_r_g_e_t_I_D
  96.           Send LIPRST to the specified device and then perform loop
  97.           initialization.  This option is much like ----llll above, except that it
  98.           also requests that the device resets itself.  Not all devices will
  99.           honor the request.  RAID controllers typically don't while disk
  100.           drives typically do.  This option can be used in rare cases where a
  101.           device is not functioning properly, but is still able to complete
  102.           loop initialization and acquire a target ID.  For example, if a
  103.           drive gets timeouts on attempts to probe (using the ----pppp option
  104.           above), then this option may bring it back to working condition.  In
  105.           this respect, the ----LLLL option can be used for reasons similar to ----rrrr on
  106.           parallel SCSI buses.
  107.  
  108.      ----LLLL aaaallllllll
  109.           This option is like the ----LLLL option directly above, except that it
  110.           directs all devices to reset themselves.  Only devices that
  111.           implement FC-AL-2 or later will respond to this.  This option can be
  112.           used if a loop is malfunctioning, and it is suspected that one or
  113.           more devices may be causing the malfunction, but it isn't known
  114.           which.  RAID controllers typically don't honor the "self-reset"
  115.           function of the LIPRST
  116.  
  117.           TTTThhhheeee ----LLLL ooooppppttttiiiioooonnnnssss mmmmaaaayyyy hhhhaaaavvvveeee aaaa ssssiiiiddddeeee eeeeffffffffeeeecccctttt ooooffff aaaabbbboooorrrrttttiiiinnnngggg ccccuuuurrrrrrrreeeennnntttt ccccoooommmmmmmmaaaannnnddddssss
  118.           oooouuuuttttssssttttaaaannnnddddiiiinnnngggg oooonnnn tttthhhheeee aaaaddddaaaapppptttteeeerrrr,,,, aaaannnndddd iiiitttt iiiiffff tttthhhheeee ddddeeeevvvviiiicccceeee hhhhoooonnnnoooorrrrssss tttthhhheeee rrrreeeesssseeeetttt
  119.           ffffuuuunnnnccccttttiiiioooonnnn,,,, oooouuuuttttssssttttaaaannnnddddiiiinnnngggg ccccoooommmmmmmmaaaannnnddddssss ttttoooo iiiitttt wwwwiiiillllllll bbbbeeee ddddrrrrooooppppppppeeeedddd....  TTTThhhheeee ddddiiiisssskkkk
  120.           ddddrrrriiiivvvveeeerrrr wwwwiiiillllllll ttttyyyyppppiiiiccccaaaallllllllyyyy rrrreeeeiiiissssssssuuuueeee tttthhhheeee aaaabbbboooorrrrtttteeeedddd ccccoooommmmmmmmaaaannnnddddssss,,,, bbbbuuuutttt tttthhhheeeerrrreeee wwwwiiiillllllll
  121.           bbbbeeee aaaa ppppeeeerrrrffffoooorrrrmmmmaaaannnncccceeee iiiimmmmppppaaaacccctttt wwwwhhhhiiiilllleeee ccccoooommmmmmmmaaaannnnddddssss aaaarrrreeee rrrreeeeiiiissssssssuuuueeeedddd aaaannnndddd wwwwhhhhiiiilllleeee aaaa
  122.           ddddeeeevvvviiiicccceeee rrrreeeesssseeeettttssss....
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. ssssccccssssiiiihhhhaaaa((((1111mmmm))))                                                          ssssccccssssiiiihhhhaaaa((((1111mmmm))))
  137.  
  138.  
  139.  
  140.      ----wwww   This option will print the portname (sometimes known as the World
  141.           Wide Name) of the fibrechannel adapter.
  142.  
  143. EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
  144.      To reset parallel scsi bus 2, use one of these commands:
  145.  
  146.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_rrrr _2222
  147.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_rrrr _////_hhhh_wwww_////_ssss_cccc_ssss_iiii______cccc_tttt_llll_rrrr_////_2222_////_bbbb_uuuu_ssss
  148.  
  149.      To probe scsi bus 0, use one of these commands:
  150.  
  151.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_pppp _0000
  152.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_pppp _////_hhhh_wwww_////_ssss_cccc_ssss_iiii______cccc_tttt_llll_rrrr_////_0000_////_bbbb_uuuu_ssss
  153.  
  154.      To reset target 8 and then perform loop initialization on fibrechannel
  155.      bus 6, do the following:
  156.  
  157.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_LLLL _8888 _6666
  158.           _ssss_cccc_ssss_iiii_hhhh_aaaa _----_LLLL _8888 _////_hhhh_wwww_////_ssss_cccc_ssss_iiii______cccc_tttt_llll_rrrr_////_6666_////_bbbb_uuuu_ssss
  159.  
  160. FFFFIIIILLLLEEEESSSS
  161.      /hw/scsi_ctlr/*/bus     the scsi bus operation devices
  162.  
  163. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  164.      ioconfig(1M), scsicontrol(1M), scsiha(7M).
  165.  
  166. NNNNOOOOTTTTEEEE
  167.      This command is normally usable only by the superuser, because the
  168.      standard permissions of the devices in /_h_w/_s_c_s_i__c_t_l_r/* restrict access to
  169.      other users.
  170.  
  171.      With Fibrechannel adapters, if a loop is broken after a system has been
  172.      operational, numerous attempts will be made to reinitialize the loop,
  173.      after which the host adapter driver will give up on the loop.  At this
  174.      point, if the hardware condition causing the broken loop is fixed (box of
  175.      drives powered back on, cable reinserted, etc.), the ----rrrr option should be
  176.      used to re-establish loop operation.
  177.  
  178.      The source to this program is also shipped as sample source code in the
  179.      iiiirrrriiiixxxx____ddddeeeevvvv....ggggiiiiffffttttssss....ssssccccssssiiii subsystem as part of IDO.
  180.  
  181.      The Performance Co-Pilot (see _P_C_P(_1)) may be used to monitor SCSI
  182.      devices, however configuration changes by _s_c_s_i_h_a may not be
  183.      asynchronously detected.  If SCSI devices are being monitored,
  184.      _l_i_b_i_r_i_x_p_m_d_a(_5) may be notified and forced to reset using the command:
  185.  
  186.                > pmstore irix.xbow.switch 1
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.